home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / texts / hsc.lha / hsc / src_docs / messages.hsc < prev    next >
Text File  |  1996-04-17  |  10KB  |  254 lines
  1. <WEBPAGE chapter="hsc - " title="Messages"
  2.     PREV="examples.html"
  3.     NEXT="copy.html">
  4.  
  5. <$macro MSG_NOTE><A HREF=":messages.html#msg_note">Note</A></$macro>
  6. <$macro MSG_STYLE><A HREF=":messages.html#msg_style">Bad style</A></$macro>
  7. <$macro MSG_WARN><A HREF=":messages.html#msg_warn">Warning</A></$macro>
  8. <$macro MSG_ERR><A HREF=":messages.html#msg_err">Error</A></$macro>
  9. <$macro MSG_FERR><A HREF=":messages.html#msg_ferr">Fatal error</A></$macro>
  10. <$macro OPTN_IGNORE><CODE><A HREF=":options.html#ignore">IGNORE</A></CODE></$macro>
  11.  
  12. <$macro msg id:string/r name:string/r class:enum("note|style|warning|error|fatal") undoc:bool>
  13. <P><DT><STRONG>
  14. <$if (set class)><$insert text=(class)></$if> <$insert text=(id)>:
  15. <$insert text=(name)></STRONG>
  16. <DD><$if (undoc)>Undocumented.</$if>
  17. </$macro>
  18.  
  19. <$MACRO insattr>attribute <I>attrib</I></$MACRO>
  20. <$MACRO instag>tag <<I>tag</I>></$MACRO>
  21. <$MACRO insval>value <I>value</I></$MACRO>
  22.  
  23. <hsc> is able to produce lots of different warnings and
  24. errors when parsing html-files. The messages alway look the same:
  25. <BLOCKQUOTE>
  26. <CODE>"file" (line#, colum#), class and message-id, message</CODE>
  27. </BLOCKQUOTE>
  28.  
  29. with
  30. <PRE>
  31.   file           input file that caused message; file names surrounded by
  32.                  "[" and "]" indicate pseudo-filenames like macros.
  33.   line#,         position in input file that caused error
  34.   colum#
  35.   class          one of <MSG_NOTE>, <MSG_WARN>, <MSG_ERR> or <MSG_FERR>
  36.   message        message text
  37. </PRE>
  38.  
  39. <HR>
  40.  
  41. <H2>Message Classes</H2>
  42.  
  43. <STRONG><A NAME="msg_note">Note</A></STRONG> is a message only for the
  44. users information. It can be suppressed using <OPTN_IGNORE>.
  45. <P>
  46. <STRONG><A NAME="msg_style">Bad style</A></STRONG> informs the user that
  47. his altough legal HTML-code includes constructs that indicate a bad style.
  48. It can be suppressed using <OPTN_IGNORE>.
  49. <P>
  50. <STRONG><A NAME="msg_port">Portability problem</A></STRONG> informs the
  51. user that his altough legal HTML-code includes constructs can lead to problems
  52. on old or buggy browsers.<OPTN_IGNORE>.
  53. <P>
  54. <STRONG><A NAME="msg_warn">Warning</A></STRONG> tells you that your source
  55. includes some problematic parts, that can lead to problems with several
  56. browsers.
  57. It can be suppressed using <OPTN_IGNORE>.
  58. <P>
  59. <STRONG><A NAME="msg_err">Error</A></STRONG> indicates that there is something
  60. wrong with your HTML-source. No output is written.
  61. <P>
  62. <STRONG><A NAME="msg_ferr">Fatal error</A></STRONG> tells you that something
  63. terrible has happened and there is no way to continue the conversion.
  64. No output is written.
  65. <P>
  66.  
  67. <HR>
  68.  
  69. <STRONG>Note:</STRONG> I've already started to collect the messages, but
  70. this list is not yet complete.
  71.  
  72. <DL>
  73. <MSG ID="1" CLASS="error" NAME="" UNDOC>
  74. <MSG ID="1" CLASS="error" NAME="" UNDOC>
  75.  
  76. <MSG ID="3" CLASS="fatal" NAME="unexpected end of file">
  77. There are still characters to be read from input, but the file
  78. already ends. Usualy, <hsc> tells you what it still expects to come.
  79.  
  80. <MSG ID="4" CLASS="error" NAME="" UNDOC>
  81.  
  82. <MSG ID="5" CLASS="error" NAME="" UNDOC>
  83. <MSG ID="6" CLASS="fatal" NAME="can not open <I>file</I> for input">
  84. An input file could not been opened. A more detailed message that tells
  85. you why is displayed, too.
  86.  
  87. <MSG ID="7" CLASS="error" NAME="" UNDOC>
  88. <MSG ID="8" CLASS="error" NAME="" UNDOC>
  89. <MSG ID="9" CLASS="error" NAME="" UNDOC>
  90. <MSG ID="10" CLASS="style" NAME='"click here" syndrome detected'>
  91. A keyword defined with the  global attribute <CODE>__CLICK_HERE__</CODE>
  92. has been found within the text inside an anchor specification.<P>
  93. Ok, now again in english: you used some term like "Click here" inside
  94. the text describing a link. This is very clumsy and should be avoided;
  95. see <A HREF="http://www.cs.cmu.edu/~tilt/cgh/index.html#linktext">Composing
  96. Good HTML</A> for details.
  97.  
  98. <MSG ID="11" CLASS="error" NAME="unknown <instag>">
  99. You refered to an unknown tag or macro.
  100.  
  101. <MSG ID="12" CLASS="error" NAME="<instag> occured too often">
  102. A tag that is expected to occure only once appeared at least twice.
  103. Remove all unneccessary occurences of the tag.
  104.  
  105. <MSG ID="13" CLASS="warning" NAME="unmatched end-<instag>">
  106. You called a end-tag without using the corresponding start-tag
  107. before.
  108.  
  109. <MSG ID="14" CLASS="warning" NAME="illegal end-tag nesting" UNDOC>
  110. A end-tag appeard where a different end-tag was expected to
  111. appear before. Example: instead of
  112. <$SOURCE PRE>
  113.         <B><I>bold and italic</B></I>
  114. </$SOURCE>
  115. you should write
  116. <$SOURCE PRE>
  117.         <B><I>bold and italic</I></B>
  118. </$SOURCE>
  119.  
  120. <MSG ID="15" CLASS="warning" NAME="required <instag> missing">
  121. A tag that is required for every document is missing.
  122.  
  123. <MSG ID="16" CLASS="warning" NAME="end-<instag> missing">
  124. You called an start-tag, but didn't end it. Insert the required
  125. end-tag.
  126.  
  127. <MSG ID="17" CLASS="error" NAME="" UNDOC>
  128. <MSG ID="18" CLASS="warning" NAME="unknown entity">
  129. You used an entity, that <hsc> doesn't know. This can happen if you
  130. made a typo, or the entity has not been defined within
  131. <FILE>hsc.prefs</FILE>.
  132.  
  133. <MSG ID="19" CLASS="error" NAME="" UNDOC>
  134. <MSG ID="20" CLASS="error" NAME="reference to unknown attribute">
  135. You referered to an attribute that doesn't exist at all.
  136.  
  137. <MSG ID="21" CLASS="warning" NAME="path to URI not found: <I>file</I>">
  138. A tag points to a local resource that doesn't exist.
  139.  
  140. <MSG ID="22" CLASS="warning" NAME="argument without quote">
  141. You passed a value to an attribute, but did not embed it into single
  142. or double quotes. This can lead to problems with older browsers.
  143.  
  144. <MSG ID="23" CLASS="error" NAME="empty reference to <insattr>">
  145. An attribute referes to an attribute that has been defined, but no
  146. value has been set for. Usually, you try to refer to an attribute
  147. inside a macro, that no value has been passed to within the call
  148. of the macro.
  149.  
  150. <MSG ID="24" CLASS="error" NAME="" UNDOC>
  151. <MSG ID="25" CLASS="style" NAME="<TG>BLINK</TG> sucks">
  152. Some browser support the non-HTML-tag <TG>BLINK</TG>. It is used
  153. to make text blinking, which annoys many users. Additionally, most
  154. of them don't know how to configure their browser that it doesn't
  155. blink, so you really should avoid it.
  156.  
  157. <MSG ID="26" CLASS="error" NAME="" UNDOC>
  158. <MSG ID="27" CLASS="error" NAME="" UNDOC>
  159. <MSG ID="28" CLASS="error" NAME="" UNDOC>
  160. <MSG ID="29" CLASS="error" NAME="" UNDOC>
  161.  
  162. <MSG ID="30" CLASS="error" NAME='unmatched ">"'>
  163. A "greater than" sign appeared inside the text. You should write
  164. "<CODE>&gt;</CODE>" instead. This can also happen, if you made
  165. an error calling a tag, and <hsc>'s parser couln't recover.
  166.  
  167. <MSG ID="31" CLASS="error" NAME="" UNDOC>
  168. <MSG ID="32" CLASS="error" NAME="" UNDOC>
  169. <MSG ID="33" CLASS="error" NAME="" UNDOC>
  170. <MSG ID="34" CLASS="error" NAME="" UNDOC>
  171. <MSG ID="35" CLASS="error" NAME="unknown <insval> for enumerator <insattr>">
  172. You tried to set an enumerator to a value it doesn't support.
  173.  
  174. <MSG ID="36" CLASS="error" NAME="" UNDOC>
  175.  
  176. <MSG ID="37" CLASS="warning" NAME="<instag> is obsolete">
  177. The tag was defined within some old HTML-version, but should
  178. not be used any more (eg. <TG>LISTING</TG>).
  179.  
  180. <MSG ID="38" CLASS="warning" NAME="<instag> is only used by jerks">
  181. This tag is no legal HTML-tag and is only supportet by special
  182. browsers.
  183.  
  184. <MSG ID="39" CLASS="error" NAME="" UNDOC>
  185. <MSG ID="40" CLASS="error" NAME="" UNDOC>
  186. <MSG ID="41" CLASS="error" NAME="" UNDOC>
  187. <MSG ID="42" CLASS="error" NAME="" UNDOC>
  188. <MSG ID="43" CLASS="error" NAME="unknown attribute option <I>option</I>">
  189. You defined a new attribute, but used an
  190. <A HREF=":macro/attrib.html#flags">option</A> that is unknown.
  191.  
  192. <MSG ID="44" CLASS="error" NAME="required <insattr> missing">
  193. An attribute that is required has not been set within the call
  194. of a tag or macro.
  195.  
  196. <MSG ID="45" CLASS="error" NAME="" UNDOC>
  197. <MSG ID="46" CLASS="note" NAME="replaced <I>char</I> by <I>entity</I>">
  198. Informs you that a special character (non-7-bit-ASCII) has been replaced
  199. by it's corresponding entity.
  200.  
  201. <MSG ID="47" CLASS="error" NAME="" UNDOC>
  202. <MSG ID="48" CLASS="error" NAME="" UNDOC>
  203. <MSG ID="49" CLASS="error" NAME="" UNDOC>
  204. <MSG ID="50" CLASS="error" NAME="" UNDOC>
  205. <MSG ID="51" CLASS="note" NAME="quote found inside text">
  206. A quote has been found inside the text. This doesn't indicate
  207. any problems, I think, but can someone tell me why they invented
  208. "<CODE>&quot</CODE>"? Probably only to be used inside strings,
  209. I think..
  210.  
  211. <MSG ID="52" CLASS="error" NAME="" UNDOC>
  212. <MSG ID="53" CLASS="error" NAME="" UNDOC>
  213. <MSG ID="54" CLASS="error" NAME="" UNDOC>
  214. <MSG ID="55" CLASS="error" NAME="" UNDOC>
  215. <MSG ID="56" CLASS="error" NAME="" UNDOC>
  216. <MSG ID="57" CLASS="error" NAME="" UNDOC>
  217. <MSG ID="58" CLASS="error" NAME="" UNDOC>
  218. <MSG ID="59" CLASS="error" NAME="" UNDOC>
  219. <MSG ID="60" CLASS="error" NAME="<instag> must be inside <instag>">
  220. Before you are allowed to use the first tag, the second tag has to
  221. occure before. Example: <TG>INPUT</TG> may only occure
  222. inside <TG>FORM</TG>.
  223.  
  224. <MSG ID="61" CLASS="error" NAME="<instag> not allowed within <instag>">
  225. A tag occures inside another tag that doesn't allowe this. For example,
  226. you can't recursively use <TG>A</TG> inside <TG>A</TG>.
  227.  
  228. <MSG ID="62" CLASS="error" NAME="no attributes allowed for end-tags">
  229. You tried to pass values to a end-tag or macro. If you need an attribute
  230. for a end-macro only, you still have to define and pass it within the
  231. opening macro.
  232.  
  233. <MSG ID="63" CLASS="warning" NAME="redefinance of <insattr>">
  234. You redefined an alredy existing attribute. If this occures during
  235. the definition of a new macro, you just tried to give two arguments the
  236. same name.
  237.  
  238. <MSG ID="64" CLASS="error" NAME="" UNDOC>
  239. <MSG ID="65" CLASS="error" NAME="" UNDOC>
  240. <MSG ID="66" CLASS="error" NAME="illegal end-tag">
  241. You tried to use a simple tag as a container.
  242.  
  243. <MSG ID="67" CLASS="error" NAME="" UNDOC>
  244. <MSG ID="68" CLASS="error" NAME="" UNDOC>
  245. <MSG ID="69" CLASS="error" NAME="" UNDOC>
  246. <MSG ID="70" CLASS="error" NAME="" UNDOC>
  247. <MSG ID="71" CLASS="error" NAME="" UNDOC>
  248.  
  249. </DL>
  250. <P>
  251.  
  252. </WEBPAGE>
  253.  
  254.